home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_1 / daterecall / english / daterecall.doc < prev    next >
Text File  |  1993-03-17  |  5KB  |  131 lines
  1.           -----------------------------------------------------
  2.                             DateRecall   V1.6  
  3.  
  4.           (C)1993 Mathias 'HCL' Delantes &  Simon 'SMB' Feldmann
  5.            -----------------------------------------------------
  6.  
  7.  
  8.  
  9.  
  10. Generalities:
  11. ------------
  12.  
  13.  This utility allows you to launch other programs or to make a line of text
  14. to be printed on screen according to a specified date. but the real specifi
  15. cation of DateRecall is that you can specifie a *interval* of two dates.
  16. You must write these dates (intevals) in a script. DateRecall searchs by de
  17. fault in 'Env:DateRecall.prefs'  but you can put the script where you like,
  18. and call it by 'DateRecall <filename>'
  19.  
  20. Working under 2.0 (>2.1 too i hope) systems as well as 1.3/1.2 .
  21. You must also have the command "run" in the directory c:
  22.  
  23. Entering a date:
  24. ---------------
  25.  
  26. The date must be written following this form: 
  27.  
  28.    DD-NN-MM-YYYY
  29.  
  30. DD corresponds to the first two letters of the name of the date's day.
  31. This can be one of these: Mo,Tu,We,Th,Fr,Sa or Su. (oh,really ??)
  32.  
  33. NN corresponds to the number of the day.
  34. MM corresponds to the number of the month.
  35. YYYY corresponds to the year.
  36.  
  37. For example: Mo-27-07-1992 corresponds to July Monday 29th of 1992.
  38.  
  39. But you can replace part of this data with the wildcard '*'.
  40. This can be very useful if you don't now to what day corresponds a date:
  41. **-12-04-1992
  42. Or if the fourth of every month are your favorite days...
  43. **-04-**-19**
  44. Or if you are superstitious...
  45. Fr-16-**-19**
  46.  
  47.  
  48. Launching a program or a line of text:
  49. --------------------------------------
  50.  
  51. You just have to write what you want after the specified dates. If you want
  52. to launch a program just tape the complete path, name and arguments, as you
  53. would do with the CLI or the SHELL.If you want a line of text to be printed
  54. on the screen you just have to write it in quotation marks. This avoids the
  55. use of the 'echo' command. Warning: don't forget one space between date and
  56. request.
  57.  
  58.  
  59. Script example:
  60. ---------------
  61.  
  62.  
  63. **-12-04-19** "Happy birthday Uncle"                    (1)
  64. **-14-07-1992 "It's the French Liberty Day"                (2)
  65. **-10-**-1992 "Pay my phone note"                    (3)
  66. Fr-13-**-1992 "Friday 13th..."                        (4)
  67. Fr-13-**-1992 c:play sample/thunder                    (5)
  68. **-**-**-**** "Urgent...send the file to Poom"                (6)
  69.  
  70. Explanations:
  71.  
  72. (1)  Write "Happy birthday Uncle" the April 12th of every year.
  73. (2)  Write "It's the French Liberty Day" the July 14th of 1992.
  74. (3)  Write "Pay my phone note" the 10th of every month of 1992.
  75. (4)  Write "Friday 13th..." every Friday 13th of 1992.
  76. (5)  Play the sample called 'thunder' every Friday 13th of 92.
  77. (6)  Write "Urgent...send the file to Poom" at anytime. This way you're
  78.      remembered for an action everytime you execute this tool.
  79.  
  80. Interval in the script:
  81. -----------------------
  82.  
  83.  You can specify a interval,which means that if you want to do something
  84. between two dates you easily can! For example, if you want to print "Den
  85. tist appointment,dear oh,  dear!" between **-12-03-92 and **-16-03-1992.
  86. In this case I suppose that the appointment's date is the 03/16.You must
  87. specify it like this:
  88. **-12-03-1992 - **-16-03-1992 "Dentist appointment,dear oh dear!"
  89. You can also launch programs and use the '*', as in simple date mode.
  90. Sa-**-**-19** - Su-**-**-19** c:play dh1:music/weekend
  91. It will play the sample 'weekend' during the interval Saturday to Sunday.
  92.  
  93. So, an interval of time is specified like this:
  94. DD-NN-MM-YYYY - DD-NN-MM-YYYY
  95.  
  96.  
  97. Tips and author's conditions:
  98. ----------------------------
  99.  
  100.  This program is freeware, this means that you can copy  it freely as long
  101. as you do not ask any more money for it than a nominal fee for copying. If
  102. you want to distribute this program you should keep this document with it.
  103. This program cannot be used for commercial purposes without written permis
  104. sion from the author.If you make any modification to this software send me
  105. a written rapport and a copy of your work. All right reserved, HCL 1992.
  106.  
  107.  
  108. Last but not least I want to thank Random (for translating),Ramus (for his
  109. help),Fakir (What nice songs),and especially SMB (alias Pipo) without whom
  110. I would not code (!) in machine code.
  111. Thanx also to Franz Schwarz for his bug report.
  112.  
  113. To contact me write to:
  114. Delantes Mathias
  115. 14 rue Rene Leynaud
  116. 69001 Lyon
  117. France
  118.  
  119. (for french users):
  120. 3615 RTEL (often enough)
  121. 78-36-19-96 Zenith rtc in Lyon (non-stop!)
  122.  
  123. or on E-Mail adress at:          (indicate that you write to HCL)
  124. gr1406@iutazoe.univ-lyon1.fr
  125.  
  126.  
  127. Thank you for contacting me for bug report and suggestions, which would
  128. allow me to improve this product... Hope you like it (?)
  129.  
  130. Translated in English by Random. Thanks to him.
  131.